Oracle TimesTen In-Memory Database C開発者およびリファレンス・ガイド

ttXlaLookup

この関数は、keysパラメータに指定されているキー値を持つ特定の表のレコードを検索します。keysおよびresultレコードの書式は、通常の行の書式と同じです。この関数では、基礎となる表に主キーが必要です。

SQLRETURN ttXlaLookup(ttXlaHandle_h handle,

ttXlaTableDesc_t *table,

void *keys,

out void *result,

SQLINTEGER maxsize,

out SQLINTEGER *retsize)


パラメータ	型	説明
handle	ttXlaHandle_h	データ・ストアのトランザクション・ログ・ハンドル。
table	ttXlaTblDesc_t *	検索する表。
keys	void *	表に対して定義された構造内のレコード。表の主キーの一部であるキー・レコードの列のみが調べられます。
result	out void *	検出されたレコードは、resultにコピーされます。一致するキー列を持つレコードが存在しない場合は、エラーが返されます。
maxsize	SQLINTEGER	resultバッファに格納可能な最大レコードのサイズ。
retsize	out SQLINTEGER *	レコードの実際のサイズ。

コールが成功すると、SQL_SUCCESSが返されます。返されない場合は、ttXlaErrorを使用してエラーをレポートします。

この例では、一組の整数キー値を指定してレコードを調べます。このコールの前に、目的の表がtableに記述され、キー列が設定されているレコードがkeybufferに含まれている必要があります。

char keybuffer[100];

char recbuffer[2000];

ttXlaTableDesc_t table;

SQLINTEGER recordSize;

rc = ttXlaLookup(xlahandle, &table, keybuffer, recbuffer,

sizeof (recbuffer), &recordSize);